KCCallbackProcPtr

KCCallbackProcPtr
Header:	Keychain.h		Carbon status:	Under Evaluation

Defines a pointer to your Keychain event-handling callback function. Your Keychain event callback function handles specified events sent by the Keychain Manager.

typedef OSStatus(* KCCallbackProcPtr) (
    KCEvent keychainEvent, 
    KCCallbackInfo *info, 
    void *userContext
);

You would declare your function like this if you were to name it MyKCCallbackCallback:

OSStatus MyKCCallback (
    KCEvent keychainEvent, 
    KCCallbackInfo *info, 
    void *userContext
);

keychainEvent: The Keychain-related event that triggers the function InvokeKCCallbackUPP to invoke your callback function. See “Keychain Event Constants” for a description of possible values. The Keychain Manager passes this value to your callback function via the keychainEvent parameter of InvokeKCCallbackUPP.
info: A pointer to a structure of type KCCallbackInfo containing information for your callback function. The Keychain Manager passes this information to your callback function via the info parameter of the function InvokeKCCallbackUPP.
userContext: A pointer to caller-defined storage. You can use this value to perform operations like track which instance of a function is operating. The Keychain Manager passes this value to your callback function via the userContext parameter of the function InvokeKCCallbackUPP.

function result: A result code.

DISCUSSION

In order for the Keychain Manager to invoke your callback function, you must register it by passing a UPP to your Keychain event callback function in the callbackproc parameter of the function KCAddCallback. You also specify the Keychain-related events that your callback function wants to receive by passing a bitmask in the eventMask parameter of KCAddCallback. See “Keychain Event Mask Constants” for a description of this mask.

When you no longer want Keychain Manager to invoke your callback function, call the function KCRemoveCallback to unregister it. For more information about responding to Keychain Manager events, see “Responding to Keychain Events”).

AVAILABILITY

Under evaluation for Carbon.